Transfer to OTC

Api yang berfungsi untuk melakukan Transfer Saldo SpeedCash

info

respon akan di dapat setelah user melakukan input pin, halaman input pin akan di informasikan terpisah, akan timeout setelah 5 menit tidak ada pin yang terinput di halaman pin

Sequence Diagram

Bagian berikut akan menjelaskan tentang detail teknis untuk proses transfer bank.

note

Pastikan partnerReferenceNo pada request dan params di url input pin sama agar terproses

Service Info

HTTP Method	POST
Service Code	42
Http Method	POST
Path	.../{version}/emoney/otc-cashout

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
Authorization	String	Y	Token B2B
Authorization-Customer	String	Y	Token B2B2C
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token B2B2C: Signature Generation
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-EXTERNAL-ID	String	Y	Nomor referensi yang harus unik pada hari yg sama
CHANNEL-ID	String	Y	00001 untuk PJP and 00002 untuk non PJP

Body

Parameter	Tipe Data	Wajib	Deskripsi
PartnerReferenceNo	String	Y	Kode Transaksi milik partner Length: <= 64 karakter
customerNumber	String	Y	Nomor Akun Pelanggan Length: <= 32 karakter
Amount	Object	Y	Jumlah
additionalInfo	Object	Y	Informasi Tambahan
merchantId	String	Y	Kode unik yang dimiliki setiap user Length: <= 64 characters
searchId	String	Y	Id tujuan transfer Length: <= 64 characters
centralId	String	C	key id master Length: <= 64 characters

Request samples

JSON

{
    "partnerReferenceNo": "9191212319191222",
    "customerNumber": "085885497322",
    "amount": {
        "value": "600.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "note": "jk tes payment",
        "merchantId": "121xxxx",
        "searchId": "121xxxxx"
    }
}

CURL

curl --location --request POST '../v1.0/emoney/otc-cashout' \
--header 'X-TIMESTAMP: 2023-01-25T11:47:00+07:00' \
--header 'X-SIGNATURE: RwABEherf+3MTBhIf6vtju6ko+YOFFKWLGgHCD5RwX1I17JCKVn8ffc/TenEIly85InhuIcKCDqDrxbIBhaKEg==' \
--header 'X-PARTNER-ID: 085224a9-4b42-4f7d-959f-4452f8a9a1ff' \
--header 'X-EXTERNAL-ID: f568600a-09f5-45ac-9576-4a130037b7c8' \
--header 'X-DEVICE-ID: android-20013adf6cdd8123f' \
--header 'CHANNEL-ID: 12345' \
--header 'Authorization: Bearer bb005fcb-dea9-499a-9e7a-bcf651b2334e' \
--header 'Authorization-Customer:Bearer 5b8bbaf8-4aca-4072-9ea8-d85bed65105f' \
--header 'Content-Type: application/json' \
--data '{
    "partnerReferenceNo": "202010290000000000001",
    "customerNumber": "081250010002",
    "otp": "127234",
    "amount": {
        "value": "10000.00",
        "currency": "IDR"
    },
    "additionalInfo": {
        "note": "jk tes payment",
        "merchantId": "1212723"
    }
}'

Response Structure

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode respons Length: <= 7 karakter
responseMessage	String	Deskripsi respons Length: <= 150 karakter
referenceNo	String	id transaksi SpeedCash Length: <= 64 karakter
additionalInfo	Object	Informasi Tambahan

Response samples

{
  "responseCode": "2004200,",
  "responseMessage": "Successful,",
  "referenceNo": "5037040,",
  "additionalInfo": {
    "description": "Anda Berhasil melakukan transfer dana   pada id 12745",
    "idTujuan": 1212745
  }
}

List Response Code API Transfer to OTC - Create Payment

Response Code	Response Message	Description
2004200	Success	Sukses
4004201	Invalid field format { field name }	Format invalid
4004202	Invalid mandatory field {field name}	Format pada bidang wajib tidak ada atau tidak valid
4014200	Unauthorized. Invalid Signature	X-Signature salah
4094200	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4044201	Bad Request	Request header ada yang salah / kurang
4044201	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait